home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmStringNCopy.z / XmStringNCopy
Encoding:
Text File  |  2002-10-03  |  2.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy - A compound string function that creates a
  10.           copy of a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.  
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy ((((_s_1, _n_u_m__b_y_t_e_s))))
  16.                XXXXmmmmSSSSttttrrrriiiinnnngggg  _s_1;;;;
  17.                iiiinnnntttt       _n_u_m__b_y_t_e_s;;;;
  18.  
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents version 1.2 of the Motif library.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy creates a copy of _s_1 that contains a specified
  25.           number of bytes, including tags, directional indicators, and
  26.           separators.  It then returns the resulting compound string.
  27.           The original strings are preserved.  The space for the
  28.           resulting compound string is allocated within the function.
  29.           The application is responsible for managing the allocated
  30.           space.  The memory can be recovered by calling XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  31.  
  32.           _s_1     Specifies the compound string.
  33.  
  34.           _n_u_m__b_y_t_e_s
  35.                  Specifies the number of bytes of _s_1 to copy.  If this
  36.                  value is less than the length of _s_1, as many bytes as
  37.                  possible, but possibly fewer than this value, will be
  38.                  appended to _s_1 such that the resulting string is
  39.                  still a valid compound string.
  40.  
  41.  
  42.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  43.           Returns a new compound string.
  44.  
  45.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  46.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee((((3333XXXX)))) and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee((((3333XXXX)))).
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.